package com.it.schoolhomeos.repository;

import com.it.schoolhomeos.entity.ClassInfo;
import com.it.schoolhomeos.entity.Student;
import com.it.schoolhomeos.entity.User;
import org.springframework.data.domain.Page;
import org.springframework.data.domain.Pageable;
import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.data.jpa.repository.Query;
import org.springframework.data.repository.query.Param;
import org.springframework.stereotype.Repository;

import java.util.List;
import java.util.Optional;

/**
 * 学生数据访问接口
 * 
 * 提供对Student实体的数据库操作方法
 * 继承JpaRepository以获取基本的CRUD操作
 */
@Repository
public interface StudentRepository extends JpaRepository<Student, Long> {
    
    /**
     * 根据班级查找学生列表
     * 
     * @param classInfo 班级信息对象
     * @return 指定班级的学生列表
     */
    List<Student> findByClassInfo(ClassInfo classInfo);
    
    /**
     * 根据班级分页查找学生列表
     * 
     * @param classInfo 班级信息对象
     * @param pageable 分页参数
     * @return 分页的学生列表
     */
    Page<Student> findByClassInfo(ClassInfo classInfo, Pageable pageable);
    
    /**
     * 根据家长查找学生列表
     * 
     * @param parent 家长用户对象
     * @return 指定家长的学生列表
     */
    List<Student> findByParent(User parent);
    
    /**
     * 根据家长分页查找学生列表
     * 
     * @param parent 家长用户对象
     * @param pageable 分页参数
     * @return 分页的学生列表
     */
    Page<Student> findByParent(User parent, Pageable pageable);
    
    /**
     * 根据班级和家长查找学生列表
     * 
     * @param classInfo 班级信息对象
     * @param parent 家长用户对象
     * @param pageable 分页参数
     * @return 分页的学生列表
     */
    Page<Student> findByClassInfoAndParent(ClassInfo classInfo, User parent, Pageable pageable);
    
    /**
     * 根据学号查找学生
     * 
     * @param studentNumber 学号
     * @return 包含学生信息的Optional对象，如果不存在则为empty
     */
    Optional<Student> findByStudentNumber(String studentNumber);

    @Query("SELECT s FROM Student s WHERE s.parent.username = :username")
    List<Student> findByParentUsername(@Param("username") String username);
    
    @Query("SELECT s FROM Student s WHERE s.id = :id AND s.parent.username = :username")
    Optional<Student> findByIdAndParentUsername(@Param("id") Long id, @Param("username") String username);
    
    /**
     * 根据ID和家长ID查找学生
     * 
     * @param id 学生ID
     * @param parentId 家长ID
     * @return 包含学生信息的Optional对象，如果不存在则为empty
     */
    @Query("SELECT s FROM Student s WHERE s.id = :id AND s.parent.id = :parentId")
    Optional<Student> findByIdAndParentId(@Param("id") Long id, @Param("parentId") Long parentId);
    
    /**
     * 根据班级列表查找学生
     * 
     * @param classInfos 班级列表
     * @return 这些班级的所有学生列表
     */
    List<Student> findByClassInfoIn(List<ClassInfo> classInfos);
    
    /**
     * 根据关键字搜索学生
     * 支持按学生姓名、学号或电话号码进行模糊查询
     * 
     * @param keyword 搜索关键字
     * @param pageable 分页参数
     * @return 符合条件的学生分页列表
     */
    @Query("SELECT s FROM Student s WHERE s.name LIKE %:keyword% OR s.studentNumber LIKE %:keyword% OR s.phone LIKE %:keyword%")
    Page<Student> findByKeyword(@Param("keyword") String keyword, Pageable pageable);
    
    /**
     * 根据班级ID和关键字搜索学生
     * 
     * @param classInfo 班级信息对象
     * @param keyword 搜索关键字
     * @param pageable 分页参数
     * @return 符合条件的学生分页列表
     */
    @Query("SELECT s FROM Student s WHERE s.classInfo = :classInfo AND (s.name LIKE %:keyword% OR s.studentNumber LIKE %:keyword% OR s.phone LIKE %:keyword%)")
    Page<Student> findByClassInfoAndKeyword(@Param("classInfo") ClassInfo classInfo, @Param("keyword") String keyword, Pageable pageable);
    
    /**
     * 根据家长ID和关键字搜索学生
     * 
     * @param parent 家长用户对象
     * @param keyword 搜索关键字
     * @param pageable 分页参数
     * @return 符合条件的学生分页列表
     */
    @Query("SELECT s FROM Student s WHERE s.parent = :parent AND (s.name LIKE %:keyword% OR s.studentNumber LIKE %:keyword% OR s.phone LIKE %:keyword%)")
    Page<Student> findByParentAndKeyword(@Param("parent") User parent, @Param("keyword") String keyword, Pageable pageable);
    
    /**
     * 根据班级ID、家长ID和关键字搜索学生
     * 
     * @param classInfo 班级信息对象
     * @param parent 家长用户对象
     * @param keyword 搜索关键字
     * @param pageable 分页参数
     * @return 符合条件的学生分页列表
     */
    @Query("SELECT s FROM Student s WHERE s.classInfo = :classInfo AND s.parent = :parent AND (s.name LIKE %:keyword% OR s.studentNumber LIKE %:keyword% OR s.phone LIKE %:keyword%)")
    Page<Student> findByClassInfoAndParentAndKeyword(@Param("classInfo") ClassInfo classInfo, @Param("parent") User parent, @Param("keyword") String keyword, Pageable pageable);
} 